home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 23 / AMIGAplus Sonderheft 23 (2000)(Falke)(DE)[!].iso / Updates / Archivierer / UnZip_v5.32 / Docs / zipinfo.doc < prev    next >
Text File  |  1999-11-06  |  24KB  |  505 lines
  1.  
  2. ZIPINFO(1L)                                           ZIPINFO(1L)
  3.  
  4. NAME
  5.        zipinfo - list detailed information about a ZIP archive
  6.  
  7. SYNOPSIS
  8.        zipinfo     [-12smlvhMtTz]     file[.zip]    [file(s) ...]
  9.        [-x xfile(s) ...]
  10.  
  11.        unzip   -Z   [-12smlvhMtTz]    file[.zip]    [file(s) ...]
  12.        [-x xfile(s) ...]
  13.  
  14. DESCRIPTION
  15.        zipinfo  lists  technical information about files in a ZIP
  16.        archive, most commonly  found  on  MS-DOS  systems.   Such
  17.        information  includes  file access permissions, encryption
  18.        status, type of compression, version and operating  system
  19.        or  file system of compressing program, and the like.  The
  20.        default behavior (with no options) is to list  single-line
  21.        entries  for  each  file  in  the archive, with header and
  22.        trailer lines providing summary information for the entire
  23.        archive.  The format is a cross between Unix ``ls -l'' and
  24.        ``unzip -v''  output.   See  DETAILED  DESCRIPTION  below.
  25.        Note  that  zipinfo  is  the  same program as unzip (under
  26.        Unix, a link to it); on  some  systems,  however,  zipinfo
  27.        support may have been omitted when unzip was compiled.
  28.  
  29. ARGUMENTS
  30.        file[.zip]
  31.               Path of the ZIP archive(s).  If the file specifica-
  32.               tion is a wildcard, each matching file is processed
  33.               in  an order determined by the operating system (or
  34.               file system).  Only the filename can be a wildcard;
  35.               the  path  itself cannot.  Wildcard expressions are
  36.               similar to Unix egrep(1) (regular) expressions  and
  37.               may contain:
  38.  
  39.               *      matches a sequence of 0 or more characters
  40.  
  41.               ?      matches exactly 1 character
  42.  
  43.               [...]  matches  any  single  character found inside
  44.                      the brackets;  ranges  are  specified  by  a
  45.                      beginning character, a hyphen, and an ending
  46.                      character.  If an  exclamation  point  or  a
  47.                      caret (`!' or `^') follows the left bracket,
  48.                      then the  range  of  characters  within  the
  49.                      brackets  is complemented (that is, anything
  50.                      except the characters inside the brackets is
  51.                      considered a match).
  52.  
  53.               (Be  sure  to quote any character that might other-
  54.               wise be interpreted or modified  by  the  operating
  55.               system,  particularly  under  Unix and VMS.)  If no
  56.               matches are found, the specification is assumed  to
  57.               be  a literal filename; and if that also fails, the
  58.  
  59. Info-ZIP             3 November 1997 (v2.22)                    1
  60.  
  61. ZIPINFO(1L)                                           ZIPINFO(1L)
  62.  
  63.               suffix .zip is appended.  Note that self-extracting
  64.               ZIP files are supported; just specify the .exe suf-
  65.               fix (if any) explicitly.
  66.  
  67.        [file(s)]
  68.               An optional list of  archive  members  to  be  pro-
  69.               cessed.   Regular  expressions  (wildcards)  may be
  70.               used to match multiple members; see above.   Again,
  71.               be  sure  to quote expressions that would otherwise
  72.               be expanded or modified by the operating system.
  73.  
  74.        [-x xfile(s)]
  75.               An optional list of archive members to be  excluded
  76.               from processing.
  77.  
  78. OPTIONS
  79.        -1     list  filenames  only,  one  per line.  This option
  80.               excludes all others; headers, trailers and  zipfile
  81.               comments are never printed.  It is intended for use
  82.               in Unix shell scripts.
  83.  
  84.        -2     list filenames only, one per line, but allow  head-
  85.               ers  (-h), trailers (-t) and zipfile comments (-z),
  86.               as well.  This option may be useful in cases  where
  87.               the stored filenames are particularly long.
  88.  
  89.        -s     list  zipfile  info in short Unix ``ls -l'' format.
  90.               This is the default behavior; see below.
  91.  
  92.        -m     list zipfile info in medium Unix ``ls -l''  format.
  93.               Identical  to  the  -s output, except that the com-
  94.               pression factor, expressed as a percentage, is also
  95.               listed.
  96.  
  97.        -l     list  zipfile  info  in long Unix ``ls -l'' format.
  98.               As with -m except  that  the  compressed  size  (in
  99.               bytes) is printed instead of the compression ratio.
  100.  
  101.        -v     list zipfile  information  in  verbose,  multi-page
  102.               format.
  103.  
  104.        -h     list  header  line.   The archive name, actual size
  105.               (in bytes) and total number of files is printed.
  106.  
  107.        -M     pipe all output through an internal  pager  similar
  108.               to  the  Unix  more(1)  command.   At  the end of a
  109.               screenful  of  output,  zipinfo   pauses   with   a
  110.               ``--More--''  prompt;  the  next  screenful  may be
  111.               viewed by pressing the Enter (Return)  key  or  the
  112.               space  bar.   zipinfo can be terminated by pressing
  113.               the  ``q''  key   and,   on   some   systems,   the
  114.               Enter/Return key.  Unlike Unix more(1), there is no
  115.               forward-searching  or  editing  capability.   Also,
  116.               zipinfo  doesn't  notice  if long lines wrap at the
  117.  
  118. Info-ZIP             3 November 1997 (v2.22)                    2
  119.  
  120. ZIPINFO(1L)                                           ZIPINFO(1L)
  121.  
  122.               edge of the screen, effectively  resulting  in  the
  123.               printing  of  two  or more lines and the likelihood
  124.               that some text will  scroll  off  the  top  of  the
  125.               screen  before  being  viewed.  On some systems the
  126.               number of available lines  on  the  screen  is  not
  127.               detected,  in which case zipinfo assumes the height
  128.               is 24 lines.
  129.  
  130.        -t     list totals for files listed or for all files.  The
  131.               number of files listed, their uncompressed and com-
  132.               pressed total sizes, and their overall  compression
  133.               factor  is  printed; or, if only the totals line is
  134.               being printed, the values for  the  entire  archive
  135.               are  given.   Note that the total compressed (data)
  136.               size will never  match  the  actual  zipfile  size,
  137.               since  the latter includes all of the internal zip-
  138.               file headers in addition to the compressed data.
  139.  
  140.        -T     print the file dates and times in a sortable  deci-
  141.               mal  format (yymmdd.hhmmss).  The default date for-
  142.               mat is a more standard, human-readable version with
  143.               abbreviated month names (see examples below).
  144.  
  145.        -z     include  the  archive comment (if any) in the list-
  146.               ing.
  147.  
  148. DETAILED DESCRIPTION
  149.        zipinfo has a number of modes, and  its  behavior  can  be
  150.        rather difficult to fathom if one isn't familiar with Unix
  151.        ls(1) (or even if one is).  The  default  behavior  is  to
  152.        list files in the following format:
  153.  
  154.   -rw-rws---  1.9 unx    2802 t- defX 11-Aug-91 13:48 perms.2660
  155.  
  156.        The  last  three fields are the modification date and time
  157.        of the file, and its name.  The case of  the  filename  is
  158.        respected;  thus  files  that  come  from MS-DOS PKZIP are
  159.        always capitalized.  If the file was zipped with a  stored
  160.        directory  name,  that  is  also  displayed as part of the
  161.        filename.
  162.  
  163.        The second and third fields indicate  that  the  file  was
  164.        zipped under Unix with version 1.9 of zip.  Since it comes
  165.        from Unix, the file permissions at the  beginning  of  the
  166.        line  are  printed in Unix format.  The uncompressed file-
  167.        size (2802 in this example) is the fourth field.
  168.  
  169.        The fifth field consists  of  two  characters,  either  of
  170.        which may take on several values.  The first character may
  171.        be either `t' or `b', indicating  that  zip  believes  the
  172.        file  to  be text or binary, respectively; but if the file
  173.        is encrypted, zipinfo notes this fact by capitalizing  the
  174.        cha